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ACRONYMS 
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1 . INTRODUCTION 

The Remote Sensing Information Subsystem is an integrated set 
of computer programs and graphic devices designed for production 
of color graphics maps and displays from digital Landsat MSS data. 
This volume describes the computer programs and how to operate 
them. See RSIS functional design Document (lec- 13258) for the 
function of each module in the overall system. 

1.1 BACKGROUND 

The RSIS was developed from the 7903 version of the the Detection 
And Mapping package (DAM) which produces black and white maps 
and displays on a line printer. All currently running DAM 
package programs may be used in the RSIS system, such as ERTS-DUP, 
ERTSIDC, PICTAB, CONTROL, CLASSIFY, PRTDENS, PRTCLASS , 
and STATUS. 

1 . 2 LANDSAT MSS DIGITAL DATA 

A Landsat scene covers an area of the Earth's surface 100x100 
nautical miles. Each scene is composed of approximately 
7,500,000 digital picture elements (pixels). The scanner co- 
ordinates defining the location of a pixel are scan line number 
and sample number. Scan lines are numbered from 1 to 2340, 
starting at the top of each scene. Samples are numbered from 
1 to 3240 (approximately) , starting at the left of each scene. 

A Landsat scene is divided into four 25-mile wide strips (num- 
bered 1 to 4 from the left) . The data for all four strips of 
the scene are recorded on either 1, 2, or 4 reels of computer 
tape, depending on the file structure and recording density. 

/ 
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The RSIS accepts the original Landsat tape format. Users, 
therefore, are not required to reformat the data prior to 
processing. 

1 . 3 COM PUTER SYSTEM REQUIREMENTS 

The computer programs in bho RSIS Univac software are designed 

for use on any Univac 1100 series computer system with the 

follow'ing minimum chax-^cteristics; 

• EXEC- 8 operating system 

• 20,000 words of user core store"' 

• 2,000,000 words of user mass storage 

• 1 tape drive (2 if tapes are to be duplicated) 

• 1 card reader 

• 1 line printer 

• 1 remote terminal (optional) 

The software is highly modular and contains provision." for 
easily specifying local hardware and system software character- 
istics at implementation time. Conversion to other computer 
systems is possible, but would involve significant reprogramming. 

The computer programs in the RSIS Interactive Graphics subsystem 
are described in RSIS Interactive Graphics Subsystem User's 
Guide. 

1.4 COMPUTER PROGRAMS 

The RSIS Univac software is currently organized in 3 main pro- 
grams. Program names and functions are as follows: 



Version 7911 


PROGR AM FUNCTION 

CLRTAB Display and tabulate raw Landsat data 

CRTCLASS Produce color graphics maps from detection 

file data 

CRLCLASS Produce color graphics maps from class data 

1 . 5 PROGRAMMING LANGUAGE 

The RSIS contains approximately 300 subroutines. Over 90 percent 
of the subroutines are written in Univac FORTRAN V, and the 
remainder in assembler and EXEC-8 control language. 

1 6 USER LAN G UAGE 

Familiarity with programming languages is not required. Users 
communicate with the computer system by means of a few English- 
like commands and exec commands . 

Exec commands generally recjuest facilities from the executive, 
prior to executing a program. They also release facilities 
after termination of a program. Those exec commands required 
for each program are explained in the section on that program. 

Commands communicate with a currently executing program. They 
are used to direct program operations and specify the nature 
of the output desired. The commands to be used with each pro- 
gram are explained below. 

CO MJvlANDS 

THE GENERAX^ FORMS FOR ALL COMMANDS ARE LISTED BELOW. MOST PRO- 
GRAMS HAVE DEFAULT VALUES FOR MANY OF THESE COMMANDS. THESE 
DEFAULT VALUES DEPEND ON THE COMPUTER INSTALLATION, THE PROGRAM, 
AND WPIETHER THE RUN IS BATCH OR DEMAND. MOST COMMANDS WILL OUTPUT 
A TABULATION OP THE CONTENTS OF VARIABLES PREVIOUSLY DEFINED BY 
THE COMMAND IF THE USER TYPES IN THE COMMAND NAME WITH NO SPECI- 
FICATIONS. 
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ADJCUoTJCf <ryPE 01* P0INTS>3 

ALlCGN3»BCAt:N3# <UNE>/ <BAMPLE>» <EARTH COORDINATE SYSTEM)* 

< COO! vTit NATE PAIR) 

ATT C I TUDE 3 t * < DEGREES PITCH ) # ( DEGRF F S ROLI. ) 3 

CHACNNJ:L3C* <PAW OR I.XNCEAR3 OR POLCAR 13 C » <CHANNEL NUMBER)C* ... 33 
CLECAR3C* {DIAGNOSTIC TYPE) 3 

COLCOR3C. <cm.l)R i)> {VALUE 1>* {COLOR 2) * {VALUE 2)3 
COP Cl ES 3 1 . { NUMBER OF OUTKJT COP I E S ) 3 
COUCNT3C* {MAXIMUM CllUNT I'ER PIXEMj 

c;rdcsstab3 

CRT C * { KUNCT [ ON > In OPEC I F I CAT I ONS > 3 3 
DENCSITV3C* {MINIMUM). {MAXIMUM) 3 
DETCECT3C. {DETECTION TYPE >3 
D I A C GRAM 3 C . { TYPE OF PO I NTS > 3 
DISCPLAY3C. {):iATA TYPE>3 
EXin 1 

EXPCLAIN3C. {PROGRAM OR COMMAND NAME)C. ... 33 
FACE TOR 3 

ORACPHCCS3C‘ {COLOR FILE NAME) C .{ IMAGE FILE NAME)33 

HLACDING3C. {LINE NUMBER) . {HEADING TEXT>3 

INTCENSITYin, {FIRST SCALING F“ACTGR> . {I.OW VALUE). 

{SECOND SCALING FACTOR) . {HIGH VALUE)3 

LINCEARIC. {LINEAR CHANNEL NUMBFJR) C . {COEFFICIENT TYPE) C . {COEFFCS ) > 1 3 3 

MAPC. {MAXIMUM NUMBER OF SUB- WINDOWS) 3 

NAMCFIIC. {NAME OF TRANSFORM OR SPECTRAL LIMITS)3 
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NEWCSn t » < PFCJORAM NAME > C # . ♦ , 3D 
NEXCT [F3»<mT OR 0N>»<Mni3E OPTION) 

OFH» < MODE OPTION) C» ... 33 
ONC»<MnDE OPTION) C* ... 33 

ORICGINDC. <COOROINATE SYSTEM) H COORDINATE PAIR)3 
PAGCK3C. <MEr.OAGE)3 
PLOC'n ER3 

CPOINT. DIPOINT NUMBER). CSC AN. 3 (LINE) . uSAMPLE). 

lEARTH [:OORniNATE SYSTEM) . (COORDINATE PAIR) I . <DESCRIPTIDN)3 

PQECAR3C. <P*T.AR CHAilNEL NlJMDhR) C » (COEFFICIENT TYPE) C . ( COEFF) 3 3 3 

PRICNTER3C. (METRIC) C. (SPECIE ICATIONS)33 

PROCFILE3 

RADI 1ANCE3C. (MINIMUM). (MAXIMUM)!. ... 33 
RENIUMPERDf (NEW WINDOW NUMBER) 

ROTCATE-3I. (CRITERIA)!. (MATRIX)!. ( NORMALIZATION) 3 3 3 
SAT!URATIONK. (COLOR CHANNEL VALUE ).( INTENSITY CHANNEL VALUE)3 
SCACLE 3 !.!/( DENOMINATOR OF REPRESENTATIVE FRACTION)3 
SCE!NE-3!. (LANOOAT SCENE NUMBER). ( S'AMPLES/SCENE) 3 
SHAIRPENINGDt . (CHANNEL NUMBER ) L . SAMIPLE3 !.( COEFF ). (COEFF ) 3 3 3 
SP A C C I NG 3 ! . ( L i; NE I NCREMENT ) . ( SAMPLE I NCREMENT ) 3 

TAB C I ILATE 3 ! . ( DATA TYPE > 3 

TIC!K INTERVAL!!. (PRIMARY COORDINATE SYSTEM ).( COORDINATE PAIR). 
(SECONDARY COORDINATE SYSTEM) . (COORDINATE PAIR >3 

TIMCE3 

TOLLERANCE3!. (VALUE) 3 
TOT!AL3 

WINIDOW3C. (COORDINATE SYSTEM)!. (COORDINATE PAIR)!. ... 333 
ZONlE3C.(UTM zone NUMBER)! 
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COLOR aOMMANO 

BK.' 3BBISKLT* 


COLCORli <DELrfTE3> 

COL COR K» < COLOR Ih (VALUE 1>» (COLOR 2>» (VALUE 2>3 
COLCOR3 f » ( COLOR 1 > / ( VALUE J > i ( » > # ( COLOR 2 > # ( VALUE 2 > 3 


EXPLANATION 

THIS CONHANO GPEOIKIES COLOR AND VALUES FOR DISPLAY. 

RESTRICTIONS 

1. USf COLORS DELETE CG'^MAND DEFORE COLORS ARE INPUT, 

2. THE COLOrPS MUST BE INPUT IN PAIRS. 

S. COLOR NAMES CAN BE DUPLICATED. 

4. COLOR VAi.JES MUST BE IS ASCENDING ORJ3ER AND IN RANGE 0 TO 63 
INCLUSIVE. 

5. THERE IS A LIMIT ON NUMBER OF COLORS. NOW 10. 

6. COLORS MAY BE REPLACED DY USING THE THIRD FORM OF COLOfi' COMMAND. 
COI.OR TO RE REIN,, AGED IS LEFT OF = SIGN. AND REPLACEMENT COLOR 
AND VALUE IS RIGHT OF = SIGN. 

PROGRAMS 

CLRTAB 

CRTCLABS 

CRLCLASS 
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OHT CCIMMAND 

ss»' . .. ssasarj a 


CRTfi riEVCItE3f aiEVICE lYPk MNEMDNIO) 

Rnii ULUTION3# <Nl<MRfcR OF (.RT FiNES) i <NUMBER OF CRT COLUMNS) 3 

SCF<f)tN F;i 2F3» {INCHES niACONAL? 


EXPLAHAflON 


THIS D IMAND -iF'ECIFIES CRT IIJNCTIUNS# 
RESTRIC.TIONS 


1, THIS CDMMANH SHOULD DE USED RARILY/ AND THEN ONLY BY 
PERSi NNEL rAMILIAR WITH THE LOCAL SYSTEMS GRAPHICS. 

2. THIS COMMAND MAY DE USED ONLY BEFORE THE FIRST WINDOW 
IN THE CUBkI NT PROGRAM HAS BEEN f^ROCESSED. 


F-ROGRAMS 


CRTCLAS.S 

CRLCLASS 


GRAPfllCS COMMAND 


GRACPHICS3C. (COLOR FILE NAMF > t .< IMAGE FILE NAME>33 
EXPLANATION 

THIS COMMAND SPECIMES FILE NAMES. 


RESTRICTIONS 


1. THE FIRST CHARACTERS OF C.’OLOR FILE NAME MUST BE V0L2; OR DS32j 
THE FIRST 5 CHARACTERS OF IMAGE FILE MAMF. MUST BE V0L2^ OR 0S32i 

2. FILE NAMFS HAVF A MAXIMUM LENGTH OF J8 CHARACTERS. 


PROGRAMS 


CLRTAB 

CRTCLASS 

CRLCLASS 


jyf 

1 


ORIQtNAL ® 

OF POOR QUAUIV 


V W 4m & al* 4 i> t t/ <Ar lb 


INTINBn y C'OHHAND 

w C . ^ JH u f ~ 1^5 w fe’ 2 r? BE 


INTCENSITY3CI <FIRBT SCALING FACTOR)# <LOW VALUE)# 
(SECOND SCALtNG FACTOR) # (H tCH VALUE)3 


EXPLANA'ITON 

THIS COMMAND SEIS SCAUNO FACTORS AND ASSOCIATED VALUES FOR COLORS, 
RESTRICTIONS 

1, SCALING FACTORS MUST BE IN RANGE 0 100 INCLUSIVE# WITH FIRST 
FACTOR LESS THAN SECOND. 

2, VAIJJES ARF: USUALLY IN RANGE 0„ Cl INCLUSIVE, 

3, MAXUMUM VALUE IS DETERMINED BY SATURATION COMMAND 

PROGR(»MS 

CLRTAB 

satukation command 

SATCl)f(ATI0N3C» <f IRST CHANNEL SATURATION LIMIT)# 

(SECOND CHANNEL SATURATION LIMIT) 3 

EXPLANATION 

THIS C:0MMAND SE3B LIMIl’S ON SATURATION VALUES. 

RESTRICTIONS 

1, THE FIRST CHANNEL SATURATION LIMIT AND SECtJND CHANNEL SATURATION 

11 

LIMIT MUST TOTAL LESS THAN 2 . 

PROGRAMS 


CLRTAB 

CRTCLASS 

CRLCl.ASS 
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1.7 COMPUTER RUN PROCEDORBS 

The basic unit for work accounting under the Univac EXEC-8 
operating system is the run. Before any programs can be executed, 
a run must first be initiated, and after tlie last program has 
terminated, the run must be terminated. The following four 
cards are always required to initiate an RSIS run (lowercase 
letters indicate user-supplied information) . 

@RUN ac counting- inf ormation 
f§USE DAM. ,name-of-program-f ile 
@ASG,A DAM. 

@ADD DAM. SETUP 

The RUN card supplies accounting information, as explained 
below. The USE card identifies t3ie external name currently 
used by the operating system for the RSIS program file 
(consult local j.nstallation standards for this name) . The ASG 
card insures that the program file is available on mass storage. 
The SETUP card prepares the programs for execution. 

The following card is always required to terminate a computer 
run : 

@FIN 

Batch runs are initiated by card input at the main computer 
site (or at a remote batch terminal) . Demand runs are initiated 
by keyboard input at an interactive remote terminal. 

1.7.1 BATCH PROCEDURE 

The procedure for using the RSIS in batch mode is listed below. 

(1) Prepare punch card deck for desired program (s) as follow 
(lowercase letters indicate user-supplied information) : 
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@RUN , priority /NR runid , acct , project , minutes , pages 

@ASG,A name-of-prograra-file 

0USE DAM. , name-of-program-filo 

@ADD DAM. SETUP 

(runstream tor program-1) 

(runstrcam for program-2) 

• • • 

(runstream for program-N) 

@FIN 

(2) Submit deck, required Landsat tape(s), and appropriate 
local form(s). The runid is a unique six-character 
identifier for each run. If not unique, error termination 
may result. 

Two commonly used characters (0 and;) are absent from most key- 
punches . Their multi-punch representations are as follows ; 

0 is multi-punch 87 
; is multi-punch 85 

1.7.2 DEMAND PROCEDURE 

The exact techniques for connecting a terminal to the computer 
and logging in are dependent on the operating system, terminal, 
and communications equipment. Once logged in, follow the pro- 
cedure below, always remembering to end each line with a car- 
riage return. (Lowercase letters indicate information supplied 
by user.) 

To initiate a demand run, enter; 

0RUN runid, acct, project 

0USE DAM. ,name-of-program file 

0ASG,A DAM. 


0ADD DAM. SETUP 
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At this point , koy in tlio requirod oxec commands and commands 
for the program (s) desired. Remember, every line must end with 
a carriage return. 

At the completion of the demand run enter: 

@FIN 


Then follow the local standards for logging off. 
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At this point, key in the required exec conuiiands and commands 
for the program (s) desired. Remember, every line must end with 
a carriage return. 

At the coraplotion of the demand run enter: 

@PIN 


Then follow the local standards for logging off. 
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At this point, key in the required exec commands and commands 
for the program (s) desired. Remember, every line must end with 
a carriage return. 

At the completion of the demand run enter; 

@FIN 


Then follow the local standards for logging off. 


2 . CLRTAB PROGRAM 


CLRTAB roailis ra\^ Landsat. MSS data from a computer compatible tape, 
and produces a magnetic display tape used for generating color 
CRT displays on the INTERDATA/RAMTEK . In these displays, each 
MSS pixel is represented by one display position on the RAMTEK 
output device. The pixel displayed in that character position 
represents: (1) the radiance, gradient, or Laplacian value 

recorded for that pixel in a given channel; (2) two channel values 
per pixel, with the first channel for that pixel being the color 
and the second channel being the intensity, or (3) the class value 
of the pixel assigned by an ISOCLS/ELLTAB Glassification run. 

Any number of displays, in any order, may be generated from one 
tape v?ithin a single program execution. However , in order to 
improve response time and minimize tape wear, displays should be 
generated in the same order that the data is stored on tape- — in 
the order of increasing line numbers. 

2 . 1 PRER E QUI SITES 

CLRTAB must bo. executed within a computer run, either batch or 
demand. Approximate scanner coordinates for displaying features 
of interest may be estimated by using a set of ERTS-1 MSS scales. 
These scales may be used for both Landsat-1 and Landsat-2. For 
information on tape staging and management, consult local in- 
stallation standards. 

2 . 2 EXEC COM MANDS 

The following exec commands are norn\ally used in executing CLRTAB 
(lowercase letters indicate user-supplied information) : 

0ASG,T 3 ., tape-unit- type , reel-number 

This exec command reserves an available 800 BPI tape drive unit 
and requests that the specified reel containing Landsat data be 
mounted. For 1600 BPI tapes, tape-unit-type will be 16N. 



Raol uuniberu ara llmitod to b oharacfcors chosen from the 
letters h-?, and the numbi'rs 0™‘). 

2., IbN, reel number 

This exec eomiuaml I’eserves an avai table KjOO BPI tape drive unit 
and request J? that a display data tape that will be sent to the 
INTERDATA/RAMTEK be mount-ed. See precodinq paragraph for unit 
and reel defiririons* 

>PS»' 2 *) , , Qua I i i i er*t' i Itniarael , 

This exec eoiumand assiqns an KbliTAB class file for the first strip 
If this fill' does not exist, this command may be omitted. 


This exec cinumand assitjns the first ELIiTAB class file to the run. 
If this file does not exist , this command may be omitted. At 
least one ElihTAR class file must bo assigned to the run. 

dUBE 2t) . , Qualif ier*filennmo2 . 

This exec command assigns an ELLTAB class file for the second 
strip. If this file does not exist, this command may bo omitted. 


dABU,A 26. 

This Gxoe command assigns the second ELLTAB class file to the run. 
If this file does not exist, lliis command may be omitted. 

dliBE 27., Qualif ior*Tilenamc3 . 

This exec command assigns an ELLTAB class file for the third strip 
If this file does not exist, this command may be omitted. 


0ASG,A 27. 

This exec command assigns the third ELLTAB class file to the run. 
If this file does not exist, this command may be omitted. 


0USE 28., Qualif ior*filename4 . 


This exec command assigns an ELLTAB class file for the fourth 
strip. If this file does not exist, this command may be omitted. 

0ASG,A 28. 

This exec command assigns the fourth ELLTAB class file to the run. 
If this file does not exist, this command may be omitted. 

@ REWIND 3. 

This exec command insures that the Landsat tape is positioned at 
the load point. 


@ REWIND 2. 

This exec command insures that the display data tap'S for the 
INTERDATA/RAMTEK is positioned at the load point. 

@XQT CLRTAB 

This exec command initiates execution. 

@ADD name-of-symbolic-element 

This exec command causes input to be taken from a symbolic element 
in a disk file, instead of from the terminal or card reader. 

At the end of the element, input is again taken from the terminal 
or card reader. This excc command is normally used to input 
spectral transformations to CLRTAB. 

0FREE 3 . 

This exec command is the opposite of the @ASG exec command. This 
command requests that the Landsat tape be dismounted and the tape 
drive released for use by other computer runs . 




@FREE 2. 


This exec command is the opposite of the @ASG exec command. This 
command requests that the display data tape be dismounted and the 
tape drive released for use by other computer runs. 

2 . 3 COMMAN DS 

The followiny commands are normally used to provide specifications 
for the CLRTAB program and direct its operations (lower-case letters 
indicate user-supplied information) : 

ORIGIN , SCAN , line , sample 

This command specifies that the origin (typically center) scan 
line and sample of the area to be processed by CLRTAB. 

WINDOW, PRINT , line , column , line , column 

This command defines the boundary, relative to the origin, of a 
rectangular area to be processed. The first coordinate pair 
specifies the minimum graphics line and column relative to the 
origin, and the second coordinate pair specifies the maximum 
graphics line and column relative to the origin. 

SPACING , line-increment , sample- increment 

This command specifies the MSS scan line and sample increments 
to be used for processing the subsequent window. 

RADIANCE , low-radiance-or-class value ,high-radiance- 
or-class value 

This command specifies the range of radiance values or class 
values used in creating the display. Any radiance or class 
values in the window which are outside of this range are ignored. 

HEADING, 1 , heading- text 

This command specifies the text heading to be displayed on the 
color CRT with the map. The text is limited to 36 characters 
and may not contain commas . 


TICK , SCAN , lines , samples , SCAN , lines , samples 

This conunand specifies the intervals for output of primary and 
secondary ticks within subsequent windows, The primary intervals 
are given first# followed by the secondary intervals. 

SATURATION, color-sot uration-limit# intensity-saturation 
limit 

This command specifies the maximum allowable value (radiance, 
function of radiance, or class) for the color channel and/or 
intensity channel. If twc channels are being processea, the 
combined values of the two may not exceed 2 -1. Any values in 

the window larger than the saturation limit are set to the limit. 

INTENSITY, first-scaling-factor , low-value , second-scaling- 
factor , high-value 

This command specifies the scaling factors associated with low 
and high values of radiance or function of radiance. This 
command is used when generating radiance, gradient, or Laplacian 
displays. It is not used with class displays. The scaling 
factors must be in the range of 0 to 100, inclusive, with the 
first factor less than the second. The normal range for the low 
and high values are 0 to 31, 

COLOR, color-namel .associated starting value ,color-name2 , 
associated starting value 

This command is analogous to tne SYMBOLS command in PICTAB. It 
specifies the color to display for a specified class or for a 
range of radiance values or function of radiance values. The 
colors must be specified in pairs and more than one color command 
is normally used. The range for a color goes from its associated 
starting value through one minus the associated starting value of 
the following color for radiance or function of radiance values; 
valid colors are listed in section 2.4. 

GRAPHICS, color-fiie-name, image-file-name 



This coitmiand specifics the name of a standard color file or image 
file in RAMTKK compatible format that has previously been saved 
on the INTKRDATA/RAMTEK , used for the current display* If no 
file names are specified/ the INTHRDATA/RAMTEK processor uses 
the color video lookup table and image data records present on 
the output tape from CLRTAB. 

DISPLAY, type or DlSl, type 

Either command requests that data for the current window be dis- 
played by CLRTAB. In the event the area specified by the current 
window and origin does not fall within the coverage of the Landsat 
tape currently mounted, the program will proceed without error 
to the next command. The DIBI macro command requests the display 
using default commands for the particular type of display speci- 
fied. Display type may be RADIANCE, GRADIENT, LAPLACIAN or CLASS 
for DISPLAY command. The display type for DISl must be RAD, GRA, 
LAP, or CL A. 

EXIT 

This command terminates the CLRTAB program. 

TABULATE, type 

This command tabulates the, number of pixels per color that were 
displayed on the preceding display. When a display of radiance 
or function of radiance (ijradiont or Laplacian) has been done, 
a range of radiance values is associated with each color. Thus, 
the tabulation would output the total of all pixels within the 
range as the total for each ac*lor. When a display of class has 
been done, one class is associated with each color. 


2 • ^ CURRENT VALID COLOR NAMES 


The current valid 

color names used 

in the 

COLOR comir.w..nd are as 

follows ; 





COLOR 

COLOR GUN 

PRIMARY OR 

NAMES 


SETTINGS 

SECONDARY 


Rod 

Green 

BiUO 

COLOR 

COl 

■"15 

0 

0 

Red 

C02 

0 

15 

0 

Green 

C03 

0 

0 

15 

Blue 

C04 

15 

15 

0 

Yellow 

COS 

15 

0 

15 

Magenta 

C06 

0 

15 

15 

Cyan 

C07 

15 

7 

0 

Yellow-Red 

COS 

7 

15 

0 

Green-Yellow 

COO 

15 

0 

7 

Red-Purple 

CIO 

7 

0 

15 

Purple-Blue 


2 . 4 RUNSTRE AM 

CLRTAB normally occurs in a soparate batch computer run from other 
programs. In this run, CLRTAB is usually executed once for each 
strip to be processed. The partial runstream required for CLRTAB 
is : 


3ASG,T 3. , tape- unit- type, reel 
^REWIND 3. 

0ASG , T 2 . , tape-unit- type , reel-number 
0REWIND 2. 


C'HJSR 25 ., class-file-name 
1<1ASG,A 25. j 

(dXQT CLRTAB 


this is needed 
for CLASS dis- 
plays only 


UADD elemont-dofining-spectral- transformation (optional) 
ORIGIN , SCAN , line , sample 

WINDOW , PRINT , line , column , line , column ) 

SPACING, line-increment, sample-increment ) 

DISPLAY , type 


repeat for 
each display 



EXIT 
WPREB 3. 
9FREE 2. 


2 • 6 SAMPLE RUN 

The foXlowiim portions of a demand terminal run illustrate typical 

use of the CIiRTAB program to produce displays from raw Landsat 

MSS data on tape. The eoraputor provides a prompt ch’^.racter (>) 

before each statement keyed in by the user. 

See Detection and Mapping Package Volume 2a: Software User's 

Manual (part 1) document (JSC-11377) 


The above exec coimnands assign the Landsat tape and position it 
at the load point and assign the output tape for the display data 
for the INTERDATA/RAMTEK. 

>0XQT CLRTAB 

Then initiate execution of the CLRTAB program. 




170AS /170AS 


DAM CLRrAB(79Xl) 


12/07/79 16? 35 


####WARNINGj JUL. 77 GODDARD FORMAT - • NO NADIR 

♦f»##l.iARNrNG! ATTITUDE MISSCNG HEE END OF CCT4 

###«WARNINGf NOMINAL REGISTRATION BASED ON tSTIMATED SCENE CENTER 
9TRK 16N 1600 IPI W^820 


LANDSAT- 

2 MSS 

SCENE’S 

20099-16033 

fCTs 

1 OF 4 

LINES? 

1 TO 2340 OF 2340 

SAMPLES? 

1 TO 016 OF 3264 

DATE? 

9 JUL 77 

CENTER? 

20.0000 90.6167 

NADIR? 

-K-K M #*# 

SUN EL? 

54 

SUN AZ? 

91 

HDD- YAW? 

##« 

ALT? 

912. 

PITCH? 

-#### 

ROLL? 


MODE /C OR 

:? 047 < OCTAL) 


CDRTAB identifies the Landsat MSS scone and strip, and then 
supplies default specifications for several commands. 

J«-m:URRENT DEFAULT COMMANDS? 

ONf t;ONHRM> LEGFND, PROMPT 

r:RT>RFS>511t511 

CRT> SCREEN# 19 

SATURArrON# 62 fi IROR CHANNEL# 31 INTENSITY CHANNEL 

INTENSITY# 0 1ST FACTR # 0 LOW VALUE# 100 2ND FACTR# 31 HIGH VALUE 

GRAPHICS # DELETE 

#*#NOTE} DELETED COLOR FILE AND IMAGE 1 ILE NAMES 
WINDOW# PRINT # 

-255 LINE# .255 COLUMN# 

255 LINE# 255 COLUMN 
SPACING# 1 LINES# 1 SAMPLES 
CHANNEL# RAW# 4 
RADIANCE# 0. 35 

TICK# SCAN# 2400 LINES# 3300 SAMPLES PRIMARY# 

SCAN# 100 LINES# 100 SAMPLES SECONDARY 
ZONE# (UTM CENTRAL MERIDIAN #***## DEG) 


The default WINDOW in this demand terminal run specifies a 
rectangular area centered on the ORIGIN, and 510 print lines by 
510 print columns in size. 

SPACINf;» 1 . 1 

SPACING^ 1 LINES# 1 SAMPLES 


The default spacing in this demand run specifies every scan line 
and every sample. 


SPACING# 1 LINES# 1 SAMPLES 
CHANKiL# RAW# 4 
RADIANi^E. 0# 35 

TICK# SCAN# 2400 LINES# 3300 SAMPLES PRIMARY# 
SCAN# 100 LINES# tOO SAMPLES SECONDARY 
ZONE# ** (UTM CENTRAL MERIDIAN DEG) 


To specify the location of the window, use the ORIGIN command. 


ORIGIN# UOO# 561 

*<hh(Warning{ bad coordinate system -- 
1100 


CLRTAB has detected a problem with the user input — the key 
word SCAN, specifying the coordinate system, was omitted. The 
user then re-enters the ORIGIN command with the correct speci- 
fications. 

ORIGIN> SiCAN» J 100» 561 
ORIGINf 1100 LINE# 561 SAMPLE 

ORIGIN# UEGREES# 28.93341 LATITUDE# 99.22617 LONGITUDE 


CLRTAB confirms the user input and estimates the geographic 
coordinates of the origin. This estimate is based on the 
approximate scene center recorded on the Landsat tape (unless 
CONTROL was executed before CLRTAB) . The user now requests a 
DISPLAY of the current WINDOW. 

DISPLAY# RADIANCE 

**#NDTt! PREVIOUS WARNINGS - BAD CIR NO DISPLAY GENERATED 
**TRY AGAIN! 


CLRTAB notes that warnings have occurred. If all problems 
have been corrected, enter DISPLAY again. 

DISPLAY# FvAD I ANCE 

WINDOW NUMrilCR 004 DISPLAY 

9TRK 16N 1600 FPI W4820 

E-20.'J99-i6n:B3~l 9JUL77 3264SAMPI.ES SIJNEL+54 PITCH-*#** ROLL-**** 
(CHAN# RAW #4, # #RAD#0 e#35 0# # #SPA# 1#1# # » ORIG# SCAN# 1100# 561) 

**«N0rE; riKFAULT IMAGE MLE SPECIFIED 



>SPACING,3,2, 

SPACING, 3 LINES, 2 SAMPLES 


This spacing command requests that one in every three lines and 
one in every two samples be displayed. This SPACING is useful 
to locate a feature when its coordinates arc known only approxi" 
mately. Once a feature has been located in this manner, the 
ORIGIN can bo refined and a now display generated with line and 
sample SPACING of 1 as follows: 

>0'rIGIN, SCAN, 865, 186j^ 

ORIGIN, SCAN, 865 LINE, 186j3f SAMPLE 

ORIGIN, DEGREES, 30.45584 LATITUDE, 95.10174 LONGITUDE 
^SPACING, 1,1 

SPACING, 1 LINES, 1 SAMPLES 
>DISPLAY 

WINDOW NUMBER 002 

E-1092-16305-3 230CT72 3240S2\MPLES SUNEL+41 PITCH+0.04 ROLL-0.52 


If a larger display is required, the WINDOW may be enlarged. 



>WINDOW, PRINT , - 120 ,- 60 , + 120 ,+60 
WINDOW, PRINT, 

-120 LINE, -60 COLUMN, 

120 LINE, 60 COLUMN 


This example specifies a WINDOVJ centered at the current ORIGIN, 
and 240-print lines by 120-print columns in size. 

Once all desired displays have been generated the user enters: 

>EXIT 

CLRTAB verifies the integrity of the Landsat tape. 

>E.XIT 

*#l'ROGRAM TERMINATION 
.. VERIFYING EOF ON ERTS TAPE 

NORMAL TERMINATION 12/07/79 17:08 0 FATAL E:RR0RS 

■K*PLIASE lill'RKE 3. OR 0REWIND 3, OR SLOCATE 3. 

>0FREE 3 
READY 


2;>ar^ 
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CLRTAB SAMPI.E RUN 

sasssi£:sssss;;UEus:ssB: 


0RUN»U/NR RJT17A»9V99-DAM--P»TF5-N12345»8f aO JONES»RJ 

eUSE DAM. »TF5-E7675B#DAM* 

0ASG»A 0AM. 
eADLi DAM. SETUP 

0ASG» r 3. » 16N»RJT1/A . SCENE t.092-16305. STRIP 2 
©REWIND 3, 

0ASG. T 2. »lvSN»DISrr.AY 
©REWIND 2. 

0XQT CERTAB 
SPACING. 1. 1 

WINDOW. PRINT. -255. -255. +255. +255 .. 510 LINKS X 510 COLUMNS. 

. . CENTERED ON ORIGIN 
*ALL OTHER DEFAULT COMMANDS ARE ACCEPTABLE 
ORIGIN. SCAN . 480 .1345 . . > D I SPI.. A Y . RAD 
ORIGIN. SCAN. A46. 947 . . .DISPLAY. RAD 
ORIGIN. SCAN. 1094.2052 . . . DISPLAY. GRA 
ORIGIN. SCAN. 1163. 1509 . .. DISPLAY. I. AP 
ORIGIN. SCAN. 1441.896 . . .DISPLAY. LAP 
ORIGIN. SCAN. 1447.1464 . . . DISPLAY. CLA 
ORIGIN. SCAN. 1603. 1710 . . . DISPLAY, CLA 
EXIT 

©REWIND 3. 

aXQT.E CLRTAB . REPEAT IF PREVIOUS EXECUTION ERROR TERMINATED 

©EOF 

©FREE 3, 

©FRtE 2. 

0ASG. T 3, . 16N.RJT17B . SCENE 1092-16305. STRIP 3 

©REWIND 3. 

0XQT CLRTAB 
©EOF 

©FREE 3. 

©FREE 2. 

©FIN 


7 ^ 
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3 . CRTCLASS PROGRAM 

CRTCLASS generates any number of custom formatted and scaled maps 
on a color graphics CRT. The maps for a Landsat MSS scene are 
displayed using data from detection file(s) produced by the CLASSIFY 
program. CRTCLASS assigns each pixel to a display position on the 
classification map. The number of Landsat pixels assigned to each 
display position will vary with the scale of the map. 


3.1 PREREQUISITES 

CRTCLASS must be executed in a computer run (normally batch) . 
CLASSIFY must be executed in the same run, prior to CRTCj.ASS, 
in order to generate the detection file(s). Tape input is required 
for CIiASSIFY, but not for CRTCLASS. However, an output tape is 
required for CRTCLASS. After CRTCLASS has run, this tape will 
contain all the necessary information used by the INTERDATA computer 
to generate the requested color maps on a color graphics CRT. 

3.2 EXEC COMMANDS 

@ASG,T 2. , tape-unit-type, reel-number 

This exec command reserves an available 1600 BPI tape drive 
unit and requests that a scratch tape be mounted. Tape-uni t-type 
for 9- track tapes is 16N. Reel numbers are limited to 6 characters 
chosen from the letters A-Z and the numbers 0-9. 

0REWIND 2. 

This exec conunand ensures that the scratch tape is positioned 
at the load point. 

@XQT CRTCLASS ’ ' 

This exec command initiates execution of the CRTCLASS program. 

0FREE 2. 

This exec command is the opposite of the @ASG exec command. This 
command requests that the scratch tape be dismounted and the tape 


drive released for use by other runs. 


3. 3 COMMANDS 

ORIGIN, DEGREES, latitude, longitude 

This command specifies the origin in degrees (typically minimum 
latitude and minimum longitude) of the area CRTCLASS is to map. 

WINDOW, PRINT, line, column 

This command specifies the size (in graphics display coordinates) 
of the rectangular area to be mapped by CRTCLASS. Latitude and 
longitude may be used with the WINDOW, MINUTES command, but the 
PRINT specification ensures that the map will fill the portion of 
screen desired. 

HEADING, 1, heading-text 

This command specifies the text to be displayed on the color CRT, 
along with the map. The text is limited to 36 characters and may 
not contain commas. 

SCALE, 1/denominator-of- representative- fraction 

This command specifies the scale at which subsequent windows are 
to be mapped. The minimum denominator is 20000 and the maximum is 
260000 (commas may not be embedded in the denominator) . 

TICK, MINUTES, latitude, longitude, MINUTES, latitude, longitude 

This command specifies the intervals for printing the primary 
ticks and secondary ticks within subsequent windows. The primary 
intervals in minutes are given first, followed by the secondary 
intervals in minutes. 




COUNT, count-per- pixel 

This command specifies the resampling algorithm used in generating 
the map. When the count-per-pixel is zero, last-in resampling is 
used. When the count-per-pixel is greater than zero, a count is 
added to a CRT display position each time a pixel registers there. 
The count added for each qualifying pixel will be either the 
(radiance/density) value or the count, whichever is less. 

SATURATION, saturation-limit 

This command specifies the largest allowable (radiance/density) 
value. Any values in the window larger than the saturation limit 
are set to the limit. This protects the CRTCLASS program from 
detection file values outside the allowable range (0-61) . The 
usual saturation limit is 61 for radiance and class detection 
files and 18 for density files. 

COLOR, color-name, first (radiance/density) value, 
color-name, second (radiance/density) value 

This command is analagous to the SYMBOLS command in PRTCLASS. It 
is used to specify the color to be displayed for a range of 
(radiance/density) values. More than one color command is usually 
specified. See section 2.4 for valid color names. 

RADIANCE, low-radiance- value, high-radiance-value 

This command specifies the range of radiance values used in 
creating the map. Any radiance values in the window which are 
outside of this range are ignored. 

DENSITY, low-density-value, high-density-value 

This command specifies the range of density values used in creating 
the map. Any density values in the window which are outside of 
this range are ignored. 



TABULATE , 


This command tabulates the number of pixels with each color or 
(radiance/density) value that was displayed by the previous MAP 
command. Pixels not displayed (outside of the current radiance/ 
density range) are not included in the tabulation. 

MAP 

This command generates a single map covering the current window. 
The map is stored on an output tape for later display on the color 
graphics CRT. 

EXIT 

This command terminates the CRTCLASS Program. 


3/ 


3 . 4 RUNSTRE/\M 


CRTCLASS is executed in the same computer run with several other 
programs. The partial runstream required for CRTCLASS is: 


• • • 

(runstream for CONTROL) 

(runstream for CLASSIFY) — repeat 
@ASG,T 2. , 16N, X09052 
@ REWIND 2. 

@XQT CRTCLASS 

ORIGIN , DEGREES , latitude , longitude 

HEADING , 1 , heading- tes t 

MAP 

EXIT 


once for each strip 


repeat for 
each area to 
be mapped 


3.5 SAMPLE RUN 

CRTCLASS always appears in a computer run (normally batch) with 
several other programs. The following portions of a demand terminal 
run illustrate combined use of the CONTROL, CLASSIFY, and CRTCLASS 
programs to produce registered color CRT maps from Landsat MSS data. 
The computer displays a prompt character (>) before each statement 
keyed in by the user. 

See Detection and Mapping Package Volume 2a: Software User's 

Manual (part 1) document (JSC-11377) page 10-4 through 10-12 
for instructions on using CONTROL and CLASSIFY. 


Next assign an output tape that will be used by CRTCLASS to store the 
maps for later display on the color graphics device. 

>0ASG,T 2., 16N, X09052 
READY 

>@ REWIND 2., 

FURPUR 0026-05/05 -1:47 


3 ^ 


Next execute CRTCLASS to generate a series of color CRT maps, 
using data in the detection files produced by CLASSIFY. 


>aXQT CRTCLASS 


CRTCLASS verifies that all detection files assigned to this run 
are for the same scene, have the same registration parameters, 
and have the same spectral limits. It then prints the following 
summary : 

170MVM/170MVM DAM DRLCLASSt 7911 ) 12/07/79 14 jM 

###M0TE} NO FtLE *DAMDET-3. 

*##N0Tt! NO FILE *DAMDET-4, 


CRTS Si;KNEj 20899-16033 
DATE.* 9 JUL 77 
SUN ELEVs 54 DEGREES 
SUN AZIMUTH! 91 DEGREES 

CCT STRIPS! 1234 


DATE CLASSIFIED! 

053179 

053179 



MINIMUM 

LINE! 

eoo 

800 

0 

0 

MAXIMUM 

LINE! 

1800 

1800 

0 

0 

MINIMUM 

SAHP/u£! 

400 

817 

0 

0 

MAXIMUM 

SAMPLE! 

816 

1632 

0 

0 


MATERIAL(S) DETECTED! WATER-LIM/2B 412F-PUR4 (DEN) 

TOLERANCE! 0 

The program then supplies default specifications for several commands. 
The default conunands for batch runs are different from those for 
demand terminal runs, and are installation dependent. 



##CURRENT DEFAULT COMMANDS i 


ON# CONFIRM# I^EGEND# PROMPT 
COPIES# 1 
DEF-DET# DEN 
DEF-DEN 

DENSITY# 10 MINIMUM# 18 MAXIMUM 
COUNT# 1 PER PIXEL 


SATURATION# 

18 COLOR 

channel# 0 

INTENSITY CHANNEL 

COLOR# COl 

COLORl# 

10 

VALUE1#C02 

C0LUR2# 

12 

VALUE2 

COLOR# C03 

COLPRl# 

14 

VALUEl # C04 

C0L0R2# 

16 

VALUE2 

COLOR# COS 

COLORl# 

17 

VALUE1#C06 

C0L0R2# 

18 

VALUE2 


SCALE# 1/24000 
WINDOW# PRINT # 

500 LINE# 500 COLUMN 

VICK# MINUTES# 2,500 LAT# 2,500 LON PRIMARY# 

MINUTES# 2.500 LAT# 2,500 LON SECONDARY 

ZONE# 14 (UTM CENTRAL MERIDIAN 99,0 D^:CI 
CRT# RES# 511 #51 I 
CRT# SCREEN# 19 
GRAPhllCS # DELETE 

***^4lJTE! DELETED COLOR FILE AND IMAGE FILE NAMES 


The default WINDOW and SCALE commands will allow a 1:24000 scale 
map to fill the entire color graphics screen. Next, specify the 
location of the map, enter its ORIGIN. 


170MVM/170MVM DAM CRTCLASS< 7911 ) 
*#USER COMMANDS: 


12/07/79 12:19 


>0RIGIN# SCAN# 1000# 600 
ORIGIN# SCAN# 1000 1. INE# 600 SAMPLE 

ORIGIN# DEGREES# 29,00973 LATITUDE# 99,19476 LONGITUDE 
ORIGIN# KM# 481.032 EAST# M208,903 NORTH 


Next specify the map HEADING and enter the MAP command. 

>HEADING#1#RSIS CRTCLASS TEST 
HEADING# 1# RSIS CRTCLASS TEST 

>MAP 

MAP 

##*NOTE: DEFAULT IMAGE FILE SPECIFIED 



CRTCLASS will then cjenerate a sinc;lo map covering the entire window. 
The map will be generated and sent to the output tape assigned to 
the run. After program termination, this tape is used by the 
INTERDATA/RAMTEK to show the display on the color graphics CRT. 

Next, a tabulation of the number of (radiance/density) pixels in 
each color range may be generated by the TABULATE command. 


>TAB 

KBTYP s COL 

WINDOW NUMBKR 001 TABULATE WATER-LIM/2B-412F-PUR4 

£-20899-16033-1 9JUL77 3264SAMPLES SUNEL+54 PlTCH+0,05 ROLL-0.11 
(CHAN» ♦O^OfO# » »RAD»10 0» 18 @,8»63i0»80» » »SPA»0#0# » » ORIG» SCAN» 1000» 600) 


COL 

DEN 

FREQUENC 

CH 0 

VAUJE 

CH 0 

CH 

aae 

010 

0 



oil 

0 


ee@ 

010 - oil 


0 

C02 

012 

0 


C02 

013 

0 


C02 

012 - 013 


0 

cos 

014 

0 


C03 

015 

0 


cos 

014 - 015 


0 

C04 

016 

0 


C04 

016 - 016 


0 

C05 

017 

0 


COS 

017 017 


0 

C06 

018 

0 


C06 

018 - 018 


0 

TOTAL 



0 


To terminate the program, enter EXIT. 

>EXIT 


*#PROGRAM TERMINATION 
DO YOU WANT DETECTION FILES SAVED? 


Unless YES is entered , CRTCLASS destroys the detection files on 
termination to conserve mass storage and prevent conflicts with 
future runs. The detection files should not be saved unless needed 
by a subsequent program in this run. 

>N0 

DETECTION PlbES DELETED 


NORMAL TERMINATION 


12 / 07/79 12»23 


O FATAL ERRORS 


Unless YES is entered, CRTCLASS destroys the detection files on 
termination to conserve mass storage and prevent conflicts with 
future runs. The detection files should not be saved unless needed 
by a subsequent program in this run. 

>N0 

DETECTION FIEES DELETED 


NORMAL TERMINATION 12/07/79 12j23 O FATAL ERRORS 
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CRTCI.<<^SS SAMPLE RUN 

SBSssnn^rsxsssssssssss: 


I5RUN» (J/NR RJT17M» 9999-DAM-P» TF5-N12345» 20» 300 
eUSk DAM. »TF5-L7675a#DAM. 

@ASG»A DAM. 
eADD DAM. BE TUP 
@ASG> T 2. » 16N» SCRATCH 
0REWIND 2. 

eUSE 25. »ELLTABCLASSFILE. 

&ABG.A ELLTABCLASSFJiLE. 
eXQT CRTCLASS 
C0PItS»l 

HEADING. 1» SAMPLE MAPS FROM THE DAM PACKAGE 
SCALE. 1/24000 

TICK. MINUTES. 7, 5. 7. 5. MINUTES. 2. 5. 2. 5 .. PRIMARY 7.5 X 7. 

. . SECONDARY 2. 5 X 

WINDOW. PRINT. 509.509 .. FILLS ENTIRE CRT SCREEN 

0RIGIN>DEG.30j15»97j37.5 HEADING. 2. AUSTIN E ...MAP 

ORIGIN. DEG. 30.‘ 15. 97.- 45 ... HEADING. 2. AUSTIN W ...MAP 

EXIT 

0FREE 2. 

eFIN 


JONES. RJ 


5 MINUTES & 
2.5 MINUTES 


4. CRLCLASS PROGRAM 


CRLCLASS generates any number of custom formatted and scaled maps 
on a color graphics CRT. The maps for a Landsat MSS scene are 
displayed using data from ELLTAB class file(s) produced by the 
ELLTAB classification program, and from detection file(s) generated 
by the CLASSIFY program. CRLCLASS assigns each pixel to a display 
position on the classification map. The number of Landsat pixels 
assigned to each display position will vary with the scale of the 
map. 


4.1 PREREQUISITES 


CRLCLASS must be executed in a computer run (normally batch) . 
CLASSIFY must be executed in the same run prior to CRLCLASS, in 
order to generate the detection file(s). The ELLTAB classification 
program must also be run prior to CRLCLASS in order to generate 
the ELLTAB class file(s). ELLTAB will normally be executed 
in a separate computer run, and the class file(s) assigned to the 
CRLCLASS run. An output tape is required for CRLCLASS. After 
CRLCLASS has run, this tape will contain all of the necessary 
information used by the INTERDATA computer to generate the 
requested color maps on a color graphics CRT. 


4.2 EXEC COMMANDS 

0ASG,T 2., tape-unit- type, reel-number 

This exec command reserves an available 1600 BPI tape drive unit 
and requests that a scratch tape be mounted. Tape-unit- type for 
9-track tapes in 16N. Reel numbers are limited to 6 characters 
chosen from the letters A-Z and the number 0-9. 


@REWIND 2. 

This exec command ensures that the scratch tape is positioned at 
the load point. 

@USE 25., Qualif ier*filenamel. 

This exec command assigns an ELLTAB class' file for the first strip. 
If this file does not exist, this command may be omitted. 

@ASG,A 25. 

This exec command assigns the first ELLTAB class file to the run. 

If this file does not exist, this command may be omitted. At 
least one ELLTAB class file must be assigned to the run. 

@USE 26., Qualif ior*filonamG2 . 

This exec command assigns an ELLTAB class file for the second strip. 
If this file does not exist, this command may be omitted. 

0ASG,A 26. 

This exec command assigns the second ELLTAB class file to the run. 

If this file does not exist, this command may be omitted. 

0USE 27., Qualif ier*filename3 . 

This exec command assigns an ELLTAB class file for the third strip. 
If this file does not exist, this command may be omitted. 

@ASG,A 27. 

This exec command assigns the third ELLTAB class file to the run. 

If this file does not exist, this command may be omitted. 

0USE 28., Qualif ier*filename4 . 

This exec command assigns an ELLTAB class file for the fourth 
strip. If this file docs pot exist, this command may be omitted. 


@ASG,A 28. 

This exec command assigns the fourth ELLTAB class file to the run. 
If this file does not exist, this comitiand may be omitted. 

@XQT CRLCLASS 

This exec command initiates execution of the CRLCLASS program. 
@PREE 2. 

This exec command is the opposite of the @AS<3 exec command. This 
command requests that the scratch tape be dismounted and the tape 
drive released for use by other runs . 

4.3 COMMANDS 

ORIGIN, DEGREES, latitude, longitude 

This command specifies the origin in degrees (typically minimum 
latitude and minimum longitude) of the area CRLCLASS is to map. 

WINDOW, PRINT, line, column 

This command specifies the size (in graphics display coordinates) 
of the rectangular area to be mapped by CRLCLASS. Latitude and 
longitude may be used with the WINDOW, MINUTES coimnand, but the 
PRINT specification ensures that the map will fill the portion of 
screen desiied. 

HEADING, 1, heading- text 

This command specifies the text to be displayed on the color CRT, 
along with the map. The text is limited to 36 characters and may 
not contain commas. 


SCALE, l/denorainator-of-representative fraction 

This command specifies the scale at which subsequent windows are 
to be mapped, The minimum denominator is 20000 and the maximum 
is 260000 (commas may not be embedded in the denominator) . 

TICK, MINUTES, latitude, longitude, MINUTES, latitude, longitude 

This command specifies the intervals for printing the primary ticks 
and secondary ticks within subsequent windows . The primary inter- 
vals in minutes are given first, followed by the secondary inter- 
vals in minutes. 

COUNT, count-per-pixel 

This command specifies the resampling algorithm used in generating 
the map. When the count-per-pixel is zero, last-in resampling is 
used. When the count-per-pixel is greater than zero, a count is 
add'vd to a CRT display position each time a pixel registers there. 
The count added for each qualifying ^ix^l will be either the class 
value or the count, whichever is less. 

> 

SATURATION, saturation-limit 

This command specifies the largest allowable class value. Any 
values in the window larger than the saturation limit are set to 
the limit. This protects the CRTCLASS Program from class values 
outside the allowable range (0-61) . The usual saturation limit 
is 61. 

COLOR, color-name, first class value, 
color-name, second class value, 

This command is analagous to the SYMBOLS command in PRTCLASS. 

It is used to specify the color to be displayed for a range of 
class values. More than one color command is usually specified. 



RADIANCE, low-class-value, high-class-value 

This command specifies the range of class values used in creating 
the map. Any class values in the window which are outside of this 
range are ignored. 

TABULATE 

This command tabulates the number of pixels with each color or 
class value that was displayed by the previous MAP command. Pixels 
not displayed (outside of the current class range) are not included 
in the tabulation. 

MAP 

This command generates a single map covering the current window. 

The map is stored on an output tape for later display on the coloj* 
graphics CRT. 

EXIT 

This command terminates the CRLCLASS program. 


4 . 4 RUNSTR KAM 

CRLCLASS is executed in the same computer run with several other 
programs. The partial runstream required for CRLCLASS is; 


(runs tr earn for CONTROL) 

(runstream for CLASSIFY) — repeat once for each strip 
@ASG,T 2. , 16N, X09052 
@ REWIND 2. 

@ASG,A 25. 

@XQT CRLCLASS 

ORIGIN, DEGREES, latitude, longitude "j repeat for 

HEADING,!, heading-text I each area to 

MAP I be mapped 

EXIT 


4.5 SMIPLE RUN 

CRI.CLASS always appears in a computer run (normally batch) with 
several other programs. The following portions of a demand termj.nal 
run illustrate combined use of the CONTROL, CLASSIFY, and CRLCLASS 
programs to produce registered color CRT maps from Landsat MSS data. 
The computer displays a prompt character (>) before each statement 
keyed in by the user. 

See Detection and Mapping Package Volume 2a: Software User's 

Manual (part 1) document (JSC-11377) page 10-4 through 10-12 
for instructions on using CONTROL and CLASSIFY. 


Next assign an output tape that will be used by CRLCLASS to store 
the maps for later display on the color graphics device. 

>0ASG,T 2. , 16N, X09052 
READY 

>0REWIND 2. 

FURPUR 0026-05/05 -1:47 


Assign at least one ELLTAB class file to the run, which contains 
the class data for the map. 



Next exeautc CRLCLABS to tjoiiorete a suriec; ot ooiur CUT maps, using 
data in the ulaos files produced by ISOCLAgs/RM.TAB . The detection 
files provide registration and scene information only 


>QXQT C;RLC;l,ASB 


CRLCLASS verifier that alJ. detection tiJes a.tsigned to this 
for the same scene, hvive the same registration parameters. 


run are 
and have 


the same spectral limits. It then prints the following summary: 


170NVM/170MVH HAM CRLO -ASS (7911) 12/077 79 12:24 

##*NDTE: NO FIL.E -^DAMDET-B, 

#ih<NiJTE; mo file *DAMDET-4, 


ERTS SCENE: 20899-16033 
DATE: 9 JUL 77 

SUM ELEO: 54 DEGREES 

SUN AZIMUTH: 91 DEGREES 


CCT STRIPS: 

1 

2 

3 4 

DATE CLASSIFIED: 

053179 

053179 


MINIMUM LINE: 

800 

800 

0 0 

MAXIMUM LINE: 

1800 

1800 

0 0 

MINIMUM SAMPLE: 

400 

817 

0 0 

MAXIMUM SAMPLE: 

816 

1632 

0 0 

MATERIAL (S) DETECTED: WATER-LIM/2B- 

-412F-PUR4 

TOLERANCE: 

0 




(DEN) 


The program then supplies default speeif ications for several commands. 
The default commands for batch runs are different from those for 
demand terminal runs, and are installation dependexit. 


##CURRENT DEFAULT COMMANDS t 


ONf COMKTRMf LEGEND » PROMPT 
COPIFSj I 
DEF-DETi CLA 
DEF-CLA 

RADIAN(3E# 0$ 6J 
COUNT/ 0 PER PIXEL 


SATURATION# 

0.1 cm. OR C/^ANNEL» 0 

INTENSITY 

' CHANMI. 

COLOR# COl 

COLDRli 

0 

VALUE.I.C02 

C0L0R2# 

10 

VA?.liE2 

COLOR# C03 

COLORl# 

20 

^'alueim:o4 

C0LHR2# 

SO 

VAUJE2 

COLOR# C05 

COLOR!# 

40 

VALUE 1#C06 

GDLUR2* 

50 

VALUE2 

COLOR# C07 

COLORl# 

55 

VALUE!# COS 

coLar<2# 

61 

VALUE2 


SCALE# 1/24000 
WINDOW# PRINT » 

500 LINE# 500 COLUMN 

TICK# MINUTES# 2»500 LAT# 2. iOO LON PRIMARY# 

MINUTES# 2.500 LAT# 2.500 LDN SECONDARY 

ZONE# 14 (UTM CENTRAL MERIDIAN Y9#0 DKO) 

CRT# RES# 511 #511 
CRT# SCREEN # 19 
GRAPHICS # DELETE 

*»-«Ni»TE} DELETED COLOR FILE «ND IM/;GE FILE NAMES 


ThB default WXND0V7 and SCALE cominands will allow a 1:24000 uca..o 
map to fill, the entire color graphics screen. Next specify che 
location of the map, enter its ORIGIN. 


1/OMVM/170MVM DAM CRLCLASS( 7911 ) 12/07/79 12fi29 

^•KUSER COMMANDS: 

>0RIGIN# SCAN# 1000# dOO 
ORIGIN# SCAN# 1000 r.INE# 600 SAMPLE 

ORIGIN# DEGREES# 29.00973 LATITUDE# 99.19476 LONGITUDE 
ORIGIN# KM# 481.032 EAST# 3208.903 NORTH 


Next specify the map HEADING and enter the MAP command . 


>HEAD I NG» 1# RSIS TEST OF CRLCLASS 
HEADING# 1# RSIS TEST OF CRLCLASS 

>MAP 

MAP 

*#^fMDTEs DEFAULT IMAGE FILE SPECIFIED 




GRLCLASS will then generate a single map covering the entire window. 
The map will be generated and sent to the output tape assigned to 
the run. After program termination, this tape is used by the INTER- 
DATA/RAMTEK to Show the display on the color graphics CRT. 

Next, a tabulation of the number of class pixels in each color 
range may be generated by the TABULATE command. 


>TAB 


KBTYP - 

COL 

WINDOW 

NUMBER 

£-20899-16033* 

(CHAN» > 

0» Of 0» f f 

COL 

CLA 

CH 0 

VALUE 

COl 

000 

C02 

OtO 

COS 

020 

C04 

030 

COS 

040 

C06 

OSO 

C07 

OSS 

COB 

061 

TOTAL 



TABULATE WATER-LIM/2B-412F-PUR4 

9JUL77 3264SAMPLES SUNEL+54 PITCH+0.05 R0LL-0«11 


FREQUENCY 
CH O CH 

0 

14 

0 

0 

0 

0 

0 

0 

14 


To terminate the program, enter EXIT. 


>EXIT 

♦♦PROGRAM TERMINATION 
DO YOU WANT DETECTION FILES SAVED? 



Unless YES is entered, CRLCLASS destroys the detection files on 
termination to conserve mass storage and prevent conflicts with 
future runs. The detection files should not be saved unless 
needed by a subsequent program in this run. 

>N0 

DETECTION FILES DELETED 


NORMAL TERMINATION 


12/07/79 12*27 


0 FATAL ERRORS 


1 7911 


CRhCLASS SAMPLE RUN 

»BaRns;^sai»BacsRtssE»ais 


e«UN»U/NR R.) ri7M*9999-DAM~P»TF5-N12345#20»300 
eUSt DAM. >TF5-L7675B#DAM. 

I1ASG»A DAM. 

SADD DAM. SETUP 
0ASG» r 2. 1 16Nf SCRATCH 
OREWIND 2. 

RUSE 25. >ELLTABCLASSFILE. 

RASG > A ELLTABCLASSF I LE . 
aXQT CRLCLASS 
COPIES. 1 

HEADING. 1. SAMPLE MAPS FROM THE DAM PACKAGE 
SCALE. 1/24000 

TICK. MINUTES. 7, 5. 7. S. minutes. 2. 5. 2. 5 .. PRIMARY 7.5 X 7. 

, . . SECONDARY 2. 5 X 

WINDOW. PRINT. 509. 509 .. FILLS ENTIRE CRT SCREEN 

0RIGIN.DLG.30a5. 97 5 37. 5 ... HEADING. 2. AUSTIN E ...MAP 
ORIGIN. DEG. 30; 15. 97t45 ... HEADING. 2. AUSTIN W ...MAP 
EXIT 
RFREE 2. 

9FIN 


JONES. RJ 


5 MINUTES 8. 
2.5 MINUTES 


